Bluetooth: HID: Implement HID Device profile #95
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add foundational HID device profile implementation: - Defines standard API: • bt_hid_device_register • bt_hid_device_connect etc - Establishes dual L2CAP channels: • Control channel (PSM=0x11) for HID commands • Interrupt channel (PSM=0x13) for report data - Manages connection lifecycle: • Handles pairing/bonding procedures • Tracks connection state transitions - Implements state reporting via callback: • bt_hid_device_register - Provides resource initialization system: • Dynamic context allocation • Protocol stack configuration Signed-off-by: Kai Cheng <[email protected]>
This commit introduces several key components for HID Device support: 1. A shell tool is implemented to interact with the HID Device layer, allowing for debugging via command line. 2. Registration of HID Device state callbacks, enabling the application to receive connection state changes. 3. Registration of HID SDP service records to support legacy Bluetooth devices that use SDP for HID device discovery. Future work will include the implementation of HID report data transmission and reception handling. Signed-off-by: Kai Cheng <[email protected]>
Add handling of incoming data on the HID Control and Interrupt channel. The received data is parsed according to the HID specification and passed to the application via the registered HID event callback. Key changes: 1. Handle HID output reports and control commands. 2. handle HID interrupt data. Signed-off-by: Kai Cheng <[email protected]>
Add HID device shell module with data reception and send handle. Signed-off-by: Kai Cheng <[email protected]>
Add robust connection handling for HID device profile: - Local-initiated connections: bt_hid_connect(addr) - Local disconnections: bt_hid_disconnect(dev) - Remote connection handling - Remote disconnection handling: - State machine supporting - Event reporting: disconnected/connected/vc_unplug Signed-off-by: Kai Cheng <[email protected]>
Implement shell operations for active connection management and transmission capabilities: - `hid_device connect`: Initiate connection to peer - `hid disconnect`: Terminate current connection - `hid send`: Send HID test data Signed-off-by: Kai Cheng <[email protected]>
EListenX
approved these changes
Oct 30, 2025
|
This PR is stale because it has been open 45 days with no activity. Remove stale label or comment or this will be closed in 10 days. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Implementation Summary
This PR adds full HID Device protocol support to Zephyr's Bluetooth stack, enabling Zephyr devices to function as Bluetooth HID peripherals (e.g., keyboards, mice). The implementation includes:
Core Protocol Infrastructure
Dual L2CAP channel management (Control PSM=0x11, Interrupt PSM=0x13)
Connection manager
Resource initialization system (bt_hid_device_init)
Standardized API for device registration and callbacks
Data Handling
Control channel command processing (SET_REPORT/GET_REPORT)
Interrupt channel report transmission
Input report reception with validation
Support for all HID report types (Input/Output/Feature)
Shell Tool
shell
Connection management
br connect DC:41:A9:XX:XX:XX
hid_device register
hid_device connect
hid_device disconnect
Data operations
hid_device send # Send mouse report
Security & Compliance
HID Spec v1.1.1 compliance
BR/EDR and BLE dual-mode support
Bonding and pairing integration